home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / base / textures.txt < prev    next >
Text File  |  1995-03-15  |  8KB  |  216 lines
  1.  
  2. LaTeX2e installation instructions
  3. for Textures users
  4.  
  5. Blue Sky Research, July 1, 1994
  6.  
  7.  
  8. SUMMARY
  9.  
  10. This file contains specific details on how to install LaTeX2e for
  11. Textures.  You should also read the general installation instructions
  12. found in 'install.txt', which will explain the overall procedures.
  13.  
  14. This file describes:
  15.  
  16.  * How to save the previous version of LaTeX 2.09;
  17.  
  18.  * How to unpack the LaTeX2e distribution;
  19.  
  20.  * How to create the LaTeX2e format;
  21.  
  22.  * How to install the LaTeX2e files.
  23.  
  24.  
  25.  
  26. FOR THOSE WHO ARE NERVOUS...!
  27.  
  28. LaTeX2e installs easily with Textures, and appropriate installation
  29. instructions follow.  Before you begin, however, here are some things to
  30. consider.
  31.  
  32. Blue Sky Research will be integrating LaTeX2e into our Classic Textures
  33. package, version 1.7, to be released in early fall.  At that time,
  34. LaTeX2e will become a regular part of our product line, and the
  35. precompiled format and necessary files will be available from Blue Sky,
  36. complete with technical support.
  37.  
  38. Although most features of LaTeX2e can be used with any version of
  39. Textures, some advanced capabilities of LaTeX2e require the virtual font
  40. facilities of Textures 1.6; others may be best handled by defining new
  41. font maps, which is beyond the ability of many users.  We expect to have
  42. prepared solutions for these issues by the time we release Textures 1.7.
  43. Although these concerns are not relevant to most users, the faint of
  44. heart (and those who like the backup of a live support staff) should
  45. consider waiting for our new release to switch to LaTeX2e.
  46.  
  47. We are not prepared to provide customer support on the use of LaTeX2e
  48. until the release of the integrated version.  However, we hope these
  49. instructions will provide the basics for successful operation of LaTeX2e
  50. until then.
  51.  
  52.  
  53.  
  54. SAVING YOUR 2.09 VERSION OF LATEX
  55.  
  56. LaTeX2e can process LaTeX 2.09 documents in most cases, so the
  57. recommended practice is to convert entirely to LaTeX2e rather than
  58. attempting to use both systems simultaneously.  However, for your own
  59. security, we recommend saving your existing LaTeX format and style files
  60. so that you can revert to LaTeX 2.09 if necessary.
  61.  
  62. This is easy!  Simply change the name of your existing LaTeX format file
  63. from 'LaTeX' to 'LaTeX 2.09' before creating the new LaTeX format file.
  64. This format can stay in the 'TeX formats' folder, or you can set it
  65. aside.  Also, make a *complete* copy of your current 'TeX inputs' folder
  66. and set it aside under, say, the name 'LaTeX 2.09 inputs'.  (Some of the
  67. files in each version of LaTeX have the same names, but different
  68. contents, so it's not possible to put the files for both versions into
  69. one 'TeX inputs' folder.)  You may use any names you choose for the
  70. set-aside folders; also, the capitalization of names is not important.
  71.  
  72. If you need to switch back to the 2.09 version of LaTeX, you will need
  73. first to quit Textures and then to swap 'TeX inputs' folders.  You do
  74. this simply by renaming the folders, i.e., rename 'TeX inputs' to
  75. 'LaTeX2e inputs', and then rename 'LaTeX 2.09 inputs' back to 'TeX
  76. inputs'.  Each time you start Textures, the folder named 'TeX inputs'
  77. *at that time* will be used for style files and other inputs. If you try
  78. to run either version of LaTeX with the wrong 'TeX inputs' folder, no
  79. harm will be done, but you will be swimming in error messages!
  80.  
  81. After switching the 'TeX inputs' folder, restart Textures, and choose
  82. the 'LaTeX 2.09' format for each document you need to typeset with the
  83. older version.
  84.  
  85. To switch back to LaTeX2e, quit Textures, and again rename the 'TeX
  86. inputs' folder(s).
  87.  
  88.  
  89. CONFIGURING TEXTURES FOR LATEX2E
  90.  
  91. LaTeX2e uses more memory than LaTeX 2.09, so you may need to increase
  92. the Textures memory partition; this is normally set to 2400K, and can be
  93. increased as necessary from the Finder.  'Get Info' of the Textures
  94. application, and enter the desired partition size, say 3000K.
  95.    
  96.  
  97. UNPACKING THE LATEX2E DISTRIBUTION
  98.  
  99. After setting aside your older LaTeX 2.09 format and 'TeX inputs'
  100. folder, download all of the LaTeX2e files from the CTAN archive into a
  101. folder called LaTeX2e.
  102.  
  103. Open 'unpack.ins' in Textures.  Choose the VirTeX format and Typeset.
  104. This will start the automated unpacking process.  Be patient, this can
  105. take some time: anywhere from 15 minutes to 3 hours depending on your
  106. Mac.
  107.  
  108. NOTE: The program will likely provide prompts telling you it has found
  109. files by the same name on the system and asking permission to overwrite.
  110. A `Yes' response WILL NOT overwrite existing files in other folders, but
  111. will create new ones in the LaTeX2e folder, so go ahead.
  112.  
  113. Using Textures, create a new file called texsys.cfg in the LaTeX2e
  114. folder just containing the line:
  115.  
  116. \let\@currdir=\@empty
  117.  
  118. This tells LaTeX that textures does not have a notion of current
  119. directory in the sense of some UNIX or other TeX implementations.
  120.  
  121.  
  122.  
  123. CREATING THE LATEX2E FORMAT
  124.  
  125.  
  126. Open 'latex.ltx' in Textures.  Again, select the VirTeX format; then,
  127. turn off Flash Mode and select `Typeset'.  Save the resulting format as
  128. `LaTeX'.  Move the new format from the LaTeX2e folder to your 'TeX
  129. formats' folder and restart Textures.  The new LaTeX format will be
  130. visible under the Typeset Menu; if the older LaTeX 2.09 format is still
  131. in the 'TeX formats' folder, it will also be visible with that name.
  132.  
  133.  
  134. PUTTING THE FILES WHERE LATEX2E CAN READ THEM
  135.  
  136. After running the install procedure, move the following files from the
  137. LaTeX2e folder into the (new) 'TeX inputs' folder:
  138.  
  139.  latexbug.tex
  140.  testpage.tex
  141.  lablst.tex
  142.  idx.tex
  143.  nfssfont.tex 
  144.  small2e.tex
  145.  sample2e.tex
  146.  docstrip.tex
  147.  *.cls
  148.  *.clo
  149.  *.sty
  150.  *.fd
  151.  *.def
  152.  *.cfg
  153.  
  154. The remaining files can remain in your LaTeX2e folder, which is probably
  155. best stored in your Textures folder.
  156.        
  157.  
  158. TESTING THE LATEX2E INSTALLATION
  159.  
  160. Open 'ltxcheck.tex' in Textures.  Select the LaTeX format, and Typeset.
  161.  
  162. You may see the following warning in the TeX Log window, this means that
  163. the texsys.cfg file described above was not used. You may either
  164. recreate a suitable texsys.cfg, and remake the format (you do not need
  165. to unpack the files again) or you can simply ignore this warning.
  166.  
  167. article.cls in current directory!
  168. ! This file should not be run in a `system directory'.
  169. \@tempa ...a `system directory'}
  170.                                 
  171. l.145 ... `system directory'}}{}
  172.  
  173. If the document finishes typesetting, all is well.  If there is an
  174. installation problem, the TeX Log will produce "BAD" warnings, and
  175. refuse to continue.
  176. Read the log for hints, fix the problem, and try again.
  177.  
  178.  
  179. REMOVING UNNECESSARY FILES
  180.  
  181. After LaTeX has been successfully installed, you might want to delete
  182. some non-essential files (after making backups) to free up space on your
  183. hard disk.  From the LaTeX2e folder, you may delete all files ending in:
  184.  
  185.                 .ins   .drv   .dtx    .fdd
  186.  
  187. Note that the dtx files are documentation, for instance, documentation
  188. on LaTeX's new class and package commands may be produced by processing
  189. the file ltclass.dtx through LaTeX. However you do not need these files
  190. on your hard disk to use LaTeX.
  191.  
  192.  
  193. POTENTIAL PROBLEMS
  194.  
  195. FONTS:
  196.  
  197. LaTeX2e in some cases calls for some fonts which are not part of the
  198. Computer Modern font set, e.g., CMSY9 and others. These fonts
  199. are available in our AMS PostScript font package.
  200.  
  201. LaTeX2e will sometimes generate many, many messages about fonts in the
  202. TeX Log.  These are diagnostic messages to aid the LaTeX2e developers,
  203. and will not interfere with successful typesetting, Closing the TeX Log
  204. window will speed up typesetting and allow you to ignore these
  205. non-essential messages. (The TeX Log window will automatically open if
  206. an error occurs.)
  207.  
  208.  
  209. INSTALLATION PROBLEMS:
  210.  
  211. If you have problems with the LaTeX installation, see the `PROBLEMS'
  212. section in install.txt.
  213.  
  214. --- Copyright 1994 Blue Sky Research and the LaTeX3 project ---
  215. ---              All rights reserved.                ---
  216.